home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / get25.zip / RUN.DOC < prev    next >
Text File  |  1991-11-29  |  2KB  |  64 lines
  1. RUN.EXE Version 1.0, Copyright (c) 1991 Bob Stephan
  2. All rights reserved.  FREE for personal use.
  3.  
  4. RUN permits you to view the ErrorLevel from a program without having 
  5. to use a long, slow BATch file to check for every possible ErrorLevel.
  6.  
  7. The syntax is:
  8.  
  9. RUN drive:\path\filename.ext arguments
  10.  
  11. where "filename" is the name of the program you want to run. It must 
  12. be qualified with the full drive, path, and the correct .COM or .EXE 
  13. extension.  The only exception is if the target program is in the 
  14. current directory in which case the drive and path may be omitted, but 
  15. the extension is required in all cases.  RUN is for .COM and .EXE programs 
  16. only.  It does not run BATch files, but since they do not return 
  17. ErrorLevel codes, it is of no use for BATch files anyway.
  18.  
  19. "arguments" are the normal arguments (parameters, switches, file 
  20. names, etc.) that you would use for the program if you were running it 
  21. from the DOS prompt.
  22.  
  23. If your program terminates normally, RUN will report:
  24.  
  25. RUN regained control!
  26. Child termination type=00h, return code=xxx
  27.  
  28. where "xxx" will be the ErrorLevel code returned by your program. 
  29. The same code will be placed in the ErrorLevel by Run where it can
  30. be checked with the IF ERRORLEVEL subcommand in a BATch file.
  31.  
  32. If the termination is not normal, you will see one of the following:
  33.  
  34. If you terminate the program with Ctrl-Break or Ctrl-C:
  35. RUN regained control!
  36. Child termination type=01h, return code=0
  37.  
  38. If you answer A to "Abort, Retry, Fail":
  39. RUN regained control!
  40. Child termination type=02h, return code=0
  41.  
  42. If RUN is unable to run your program, you might see one of the 
  43. following:
  44.  
  45. EXEC call failed, error code=02h.
  46. File not found - check for drive, path, filename, and extension.
  47.  
  48. EXEC call failed, error code=03h.
  49. Path not found - check drive and path.
  50.  
  51. EXEC call failed, error code=04h.
  52. Too many open files.
  53.  
  54. EXEC call failed, error code=05h.
  55. Access denied - check for .EXE or .COM extension.
  56.  
  57. EXEC call failed, error code=08h.
  58. Not enough memory.
  59.  
  60. If you have any questions, comments, or suggestions please contact me at:
  61.     MOBY DISK: 1021 San Carlos Road, Pebble Beach, CA 93953
  62. Phone: (408) 646-1899/1373.    GENIE:MOBYDISK.      COMPUSERVE:72357,2276
  63. BBS: The Cricket 408-373-3773         /s/ Bob Stephan   November 27, 1991
  64.